* @param string $file Filename
* @param array $context Additional logging context data
* @throws MWException
- * @deprecated since 1.25 Use \\MediaWiki\\Logger\\LegacyLogger::emit or UDPTransport
+ * @deprecated since 1.25 Use \MediaWiki\Logger\LegacyLogger::emit or UDPTransport
*/
function wfErrorLog( $text, $file, array $context = array() ) {
wfDeprecated( __METHOD__, '1.25' );
* See documentation in DefaultSettings.php for detailed explanations of each
* variable.
*
- * @see \\MediaWiki\\Logger\\LoggerFactory
+ * @see \MediaWiki\Logger\LoggerFactory
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* @copyright © 2014 Bryan Davis and Wikimedia Foundation.
protected $channel;
/**
- * Convert Psr\\Log\\LogLevel constants into int for sane comparisons
+ * Convert \Psr\Log\LogLevel constants into int for sane comparisons
* These are the same values that Monlog uses
*
* @var array $levelMapping
*
* @param string $channel
* @param string $message
- * @param string|int $level Psr\\Log\\LogEvent constant or Monlog level int
+ * @param string|int $level \Psr\Log\LogEvent constant or Monlog level int
* @param array $context
* @return bool True if message should be sent to disk/network, false
* otherwise
* );
* @endcode
*
- * @see \\MediaWiki\\Logger\\LoggerFactory
+ * @see \MediaWiki\Logger\LoggerFactory
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* @copyright © 2014 Bryan Davis and Wikimedia Foundation.
* Get a logger instance.
*
* @param string $channel Logging channel
- * @return \\Psr\\Log\\LoggerInterface Logger instance
+ * @return \Psr\Log\LoggerInterface Logger instance
*/
public function getLogger( $channel ) {
if ( !isset( $this->singletons[$channel] ) ) {
/**
* PSR-3 logger instance factory.
*
- * Creation of \\Psr\\Log\\LoggerInterface instances is managed via the
+ * Creation of \Psr\Log\LoggerInterface instances is managed via the
* LoggerFactory::getInstance() static method which in turn delegates to the
* currently registered service provider.
*
* $wgMWLoggerDefaultSpi is expected to be an array usable by
* ObjectFactory::getObjectFromSpec() to create a class.
*
- * @see \\MediaWiki\\Logger\\Spi
+ * @see \MediaWiki\Logger\Spi
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* @copyright © 2014 Bryan Davis and Wikimedia Foundation.
/**
* Service provider.
- * @var \\MediaWiki\\Logger\\Spi $spi
+ * @var \MediaWiki\Logger\Spi $spi
*/
private static $spi;
/**
- * Register a service provider to create new \\Psr\\Log\\LoggerInterface
+ * Register a service provider to create new \Psr\Log\LoggerInterface
* instances.
*
- * @param \\MediaWiki\\Logger\\Spi $provider Provider to register
+ * @param \MediaWiki\Logger\Spi $provider Provider to register
*/
public static function registerProvider( Spi $provider ) {
self::$spi = $provider;
* Spi registration. $wgMWLoggerDefaultSpi is expected to be an
* array usable by ObjectFactory::getObjectFromSpec() to create a class.
*
- * @return \\MediaWiki\\Logger\\Spi
+ * @return \MediaWiki\Logger\Spi
* @see registerProvider()
* @see ObjectFactory::getObjectFromSpec()
*/
* Get a named logger instance from the currently configured logger factory.
*
* @param string $channel Logger channel (name)
- * @return \\Psr\\Log\\LoggerInterface
+ * @return \Psr\Log\LoggerInterface
*/
public static function getInstance( $channel ) {
static $hasPSR3Interface = null;
* name will return the cached instance.
*
* @param string $channel Logging channel
- * @return \\Psr\\Log\\LoggerInterface Logger instance
+ * @return \Psr\Log\LoggerInterface Logger instance
*/
public function getLogger( $channel ) {
if ( !isset( $this->singletons['loggers'][$channel] ) ) {
* Create a logger.
* @param string $channel Logger channel
* @param array $spec Configuration
- * @return \\Monolog\\Logger
+ * @return \Monolog\Logger
*/
protected function createLogger( $channel, $spec ) {
$obj = new Logger( $channel );
/**
* Create or return cached handler.
* @param string $name Processor name
- * @return \\Monolog\\Handler\\HandlerInterface
+ * @return \Monolog\Handler\HandlerInterface
*/
public function getHandler( $name ) {
if ( !isset( $this->singletons['handlers'][$name] ) ) {
/**
* Create or return cached formatter.
* @param string $name Formatter name
- * @return \\Monolog\\Formatter\\FormatterInterface
+ * @return \Monolog\Formatter\FormatterInterface
*/
public function getFormatter( $name ) {
if ( !isset( $this->singletons['formatters'][$name] ) ) {
use Psr\Log\NullLogger;
/**
- * LoggerFactory service provider that creates \\Psr\\Log\\NullLogger
+ * LoggerFactory service provider that creates \Psr\Log\NullLogger
* instances. A NullLogger silently discards all log events sent to it.
*
* Usage:
- * @code
- * $wgMWLoggerDefaultSpi = array(
- * 'class' => '\\MediaWiki\\Logger\\NullSpi',
- * );
- * @endcode
*
- * @see \\MediaWiki\\Logger\\LoggerFactory
+ * $wgMWLoggerDefaultSpi = array(
+ * 'class' => '\\MediaWiki\\Logger\\NullSpi',
+ * );
+ *
+ * @see \MediaWiki\Logger\LoggerFactory
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* @copyright © 2014 Bryan Davis and Wikimedia Foundation.
class NullSpi implements Spi {
/**
- * @var \\Psr\\Log\\NullLogger $singleton
+ * @var \Psr\Log\NullLogger $singleton
*/
protected $singleton;
* Get a logger instance.
*
* @param string $channel Logging channel
- * @return \\Psr\\Log\\NullLogger Logger instance
+ * @return \Psr\Log\NullLogger Logger instance
*/
public function getLogger( $channel ) {
return $this->singleton;
namespace MediaWiki\Logger;
/**
- * Service provider interface for \\Psr\\Log\\LoggerInterface implementation
+ * Service provider interface for \Psr\Log\LoggerInterface implementation
* libraries.
*
* MediaWiki can be configured to use a class implementing this interface to
- * create new \\Psr\\Log\\LoggerInterface instances via either the
+ * create new \Psr\Log\LoggerInterface instances via either the
* $wgMWLoggerDefaultSpi global variable or code that constructs an instance
* and registers it via the LoggerFactory::registerProvider() static method.
*
- * @see \\MediaWiki\\Logger\\LoggerFactory
+ * @see \MediaWiki\Logger\LoggerFactory
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* @copyright © 2014 Bryan Davis and Wikimedia Foundation.
* Get a logger instance.
*
* @param string $channel Logging channel
- * @return \\Psr\\Log\\LoggerInterface Logger instance
+ * @return \Psr\Log\LoggerInterface Logger instance
*/
public function getLogger( $channel );
* Get the writer for the named channel
*
* @var string $channel Name of the schema to fetch
- * @return \\AvroSchema|null
+ * @return \AvroSchema|null
*/
protected function getSchema( $channel ) {
if ( !isset( $this->schemas[$channel] ) ) {
use Monolog\Handler\BufferHandler as BaseBufferHandler;
/**
- * Updates \\Monolog\\Handler\\BufferHandler to use DeferredUpdates rather
+ * Updates \Monolog\Handler\BufferHandler to use DeferredUpdates rather
* than register_shutdown_function. On supported platforms this will
* use register_postsend_function or fastcgi_finish_request() to delay
* until after the request has shutdown and we are no longer delaying
/**
* Log message formatter that mimics the legacy log message formatting of
* `wfDebug`, `wfDebugLog`, `wfLogDBError` and `wfErrorLog` global functions by
- * delegating the formatting to \\MediaWiki\\Logger\\LegacyLogger.
+ * delegating the formatting to \MediaWiki\Logger\LegacyLogger.
*
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* @copyright © 2013 Bryan Davis and Wikimedia Foundation.
- * @see \\MediaWiki\\Logger\\LegacyLogger
+ * @see \MediaWiki\Logger\LegacyLogger
*/
class LegacyFormatter extends NormalizerFormatter {
* channel as the prefix value.
*
* When not targeting a udp2log stream this class will act as a drop-in
- * replacement for \\Monolog\\Handler\\StreamHandler.
+ * replacement for \Monolog\Handler\StreamHandler.
*
* @since 1.25
* @author Bryan Davis <bd808@wikimedia.org>
* Monolog's SyslogUdpHandler creates a partial RFC 5424 header (PRI and
* VERSION) and relies on the associated formatter to complete the header and
* message payload. This makes using it with a fixed format formatter like
- * \\Monolog\\Formatter\\LogstashFormatter impossible. Additionally, the
+ * \Monolog\Formatter\LogstashFormatter impossible. Additionally, the
* direct syslog input for Logstash only handles RFC 3164 syslog packets.
*
* This Handler should work with any Formatter. The formatted message will be
/**
* Get the OOUI widget for this field.
* @param string $value
- * @return OOUI\\ButtonInputWidget
+ * @return OOUI\ButtonInputWidget
*/
public function getInputOOUI( $value ) {
return new OOUI\ButtonInputWidget( array(
* Get the OOUI version of this field.
* @since 1.26
* @param string $value
- * @return OOUI\\CheckboxInputWidget The checkbox widget.
+ * @return OOUI\CheckboxInputWidget The checkbox widget.
*/
public function getInputOOUI( $value ) {
if ( !empty( $this->mParams['invert'] ) ) {
* Defaults to false, which getOOUI will interpret as "use the HTML version"
*
* @param string $value
- * @return OOUI\\Widget|false
+ * @return OOUI\Widget|false
*/
function getInputOOUI( $value ) {
return false;
*
* @param string $value The value to set the input to.
*
- * @return OOUI\\FieldLayout|OOUI\\ActionFieldLayout
+ * @return OOUI\FieldLayout|OOUI\ActionFieldLayout
*/
public function getOOUI( $value ) {
$inputField = $this->getInputOOUI( $value );
/**
* Get a FieldLayout (or subclass thereof) to wrap this field in when using OOUI output.
- * @return OOUI\\FieldLayout|OOUI\\ActionFieldLayout
+ * @return OOUI\FieldLayout|OOUI\ActionFieldLayout
*/
protected function getFieldLayoutOOUI( $inputField, $config ) {
if ( isset( $this->mClassWithButton ) ) {
/**
* Put a form section together from the individual fields' HTML, merging it and wrapping.
- * @param OOUI\\FieldLayout[] $fieldsHtml
+ * @param OOUI\FieldLayout[] $fieldsHtml
* @param string $sectionName
* @param bool $anyFieldHasLabel Unused
* @return string HTML